ADDENDUM 


Kontron 7000CB Graphics Controller 
Programmer’s Manual 


Revision 3.20 Software 

The KON7K library diskette that accompanies your 
programmer’s manual is the latest version: Software 
Revision 3.20, August 1988. The following files are on 
the revision 3.20 diskette: 


7k.sys 


kon7k.lib 

*.h 


7klx.dat 


7k2x.dat 


7k3x.dat 


System driver for the Kontron 
7000CB; 

Driver library for Microsoft C; 

Include files (alias.h, init.h, 
kon7k.h, q.h, vram.h) that provide 
definitions and structures; 

Hardware configuration data set 
for the K7000CB/1 board (1280 
by 1024 by 8); 

Hardware configuration data set 
for the K7000CB/2 board (1280 
by 1024 by 4); 

Hardware configuration data set 
for the K7000CB/3 board (1024 
by 780 by 8); 
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7k4x.dat 

7k.cfg 

setup7k.exe 

*.fnt 

egaon.exe; 

egaoff.exe 

egaset.exe 

config.sys 

ctest.c, 

ctest.exe 

tkon7k.exe 

default.lut 
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Hardware configuration data set 
for the K7000CB/4 board (1024 
by 780 by 4); 

x = s, m, or p for Sony, Mitsubi¬ 
shi, or Philips monitors, respec¬ 
tively; 

Executable form of configuration 
file for K7000CB; 

Conversion program to generate 
7k.cfg from the 7knx.dat file; 

Bitmap text fonts; 

Switches EGA driver on; 

Switches EGA driver off; 
Configures and modifies the EGA 
driver parameter settings; 

Addendum to your standard 
config.sys, to allow loading the 
7k.sys driver, 


Test image program; 

Toolbox program for generating 
various demo and benchmark 
graphic images; 

ASCH lookup table file. 
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Installing the KON7K Rev. 3.20 Software 

1. If necessary, edit the 7kzu.dat software 
configuration data file to your specifications. Refer 
to Chapter 3 of the programmer’s manual. 

2. To install the software for your particular board 
version, import the 7knx.dat file into the 
configuration file by executing the setup command 

setup 7k 7knx.dat 7k.cfg 

where n represents the numbers 1 through 4, 
depending on the model of K7000CB con toller that 
you possess, and x represents the letters s, m, or p 
for Sony, Mitsubishi, or Philips monitors. 

For instance, if you want to install the Kontron 
7000CB/4 board (1024 by 780 by 4 bit resolution), 
and you have a Philips monitor, enter 

setup7k 7k4p.dat 7k.cfg 

3. Copy the driver, configuration, and text font files 
into the boot directory (typically C:\): 

7k.sys 

7k*.dat 

7k.cfg 

*.fnt 
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These files are sufficient for applications based on 
the standard KON7K library. However, specialized 
drivers, e.g.. Computer Vision or AutoCAD, require 
their own configuration files: 

7kadi.sys (AutoCAD) or 
7kcv.sys (Computer Vision) 

4. Also copy the configuration file and text font files 
into your current working directory: 

7k.cfg *.fnt 


Enhancements 

The revision 3.20 software has the following 
enhancements not described in the programmer’s 
manual: 

• The k7_dpl, k7_pgfill, k7_xfm, and k7_xfmc 
functions were corrected. 

• The dsp_zoom, dsp_pan, dsp_pick, and dsp_call 
display list functions now return an integer 
parameter, as follows: 

1 Display list is valid; 

0 Display list was erased because of 
overflow. 

• There are nine new functions, described in the 
following pages. 
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dsp_switch 


Switches display list output. 

void dsp_switch(,ywzrc/z, path); 
int switch; 

char path; 

Allows you to choose an XRAM memory board extension of the 
graphics board, or use file access for display list maintenance 
(which is slower). This function switches display list output as 
follows: 

switch = 0 XRAM of K7000CB 

switch = 1 hard disk, file path 


k7_getpt 


Accesses parameters of the 7k.sys driver. 

void k7_getpt(pte); 
struct P pts; 

Returns an array of pointers to the driver 7k.sys, defining all local 
data structures, which are also defined in vram.h. This function is 
used to access all variables present in the driver, e.g., the board base 
address, interrupt or DMA channels from the configuration file 
7k.cfg, or EGA parameters. 

Example: Listing A-1 
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k7_bi 


Block input to master or slave QPDM. 

void k7J)i(count, Buffer ); 

int count, Buffer; 

Block input, 4 bits. The activity bits decide between the master or 
slave QPDM: 

Call k7_act(0x0f) to perform block input to the master QPDM. 
Call k7_act(0xf0) to perform block input to the slave QPDM. 


k7_bom 


Block output from master QPDM. 

void k7_bom(counf, Buffer)-, 

int count. Buffer; 

Block output, 4 bits. 

Example: Listing A-2 


k7_bos 


Block output from slave QPDM. 

void kljoos(count, Buffer)-, 

int count, Buffer; 

Block output, 4 bits. 

Example: Listing A-2 
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k7_p4to8 


Buffer conversion. 

void p4to8 (masterBuffer, slaveBuffer, count, image8Buffer)\ 

int masterBuffer, slaveBuffer, count, image8Buffer; 

Converts the two 4-bits/pixel buffers from the master and slave 
QPDM to one buffer with 8 bits/pixel. 


k7_bi8 


8-bit block input. 

void k7„bi8(c<?wU, Buffer ); 

int count, Buffer; 

This function performs a block input with 8 bits/pixel. It is 
identical to k7_bi of the earlier software version. 

Block output can only be done using two buffers, one containing 4 
bits/pixel from the master QPDM and the other containing 4 
bits/pixel from the slave QPDM. These buffers can be used for the 
k7_bi function to perform a block input-the activity bits decide if 
the buffer is transferred to the master or to the slave QPDM. Use 
this method if you want to make a backup of the screen image 
without using the image data as input for other purposes. 

If you want to access the image data, it is best to convert the two 
buffers to a byte stream with 8 bits/pixel. Use the k7_p4to8 
function to do this. 

Set the bis and bos parameters (of the k7_ibl and k7_obl functions) 
to 4 when using k7_bi8. 

Example: Listing A-3 
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k7_seldev 


Selects one of multiple (independent) K7000CB boards. 

void k7_seldev(ttfev); 

int idev; 

This function supports multiple K7000CB boards (independent, not 
cascaded) driving multiple displays. The parameter idev 
(0,l,...max-l) selects a particular board. Note that the boards must 
be configured in sequential address space, e.g., 

board # 0 I/O space 300h 

board # 1 I/O space 320h 

board # 2 I/O space 340h 

board # 3 I/O space 360h 

Note: When initializing the system, call the k7_ini function once, 
but call k7_res once for each board. For example: 

k7_ini("\\7k.cfg"); 
for (i=0; knboard; i++) 

{ I* loop over all boards */ 
k7_seldev(i); 
k7_res(); 
k7_fntld(); 

k7_usrlut("default.lut"); 

} 
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k7_fi!out 


Supports QPDM FIFO to a DOS file. 

void k7__filout (handle)', 

int handle; 

This function supports on-line QPDM FIFO command level output 
to a DOS file. The parameter handle is the file handler, which is 
previously opened via the "open” function (in MS-C) or the DOS 
interrupt 3dh for file open. Setting handle = -1 disables the log file 
function. 

Example: Listing A-4 
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Listing A-1: Access 7k.sys Parameters via Pointers 


#include "vram.h" 

dspparams() /* display 7k.sys params*/ 

{ 

struct P { I* param ptr structure 7 

QSTAT ‘qstat; /* QPDM status variables 7 

char ‘entryp; 

struct K7_CNF *k7_cnf; /* configuration (7k.dat file) 7 
char ‘modes; 

EGAWIN ‘egawin; /* EGA parameters 7 

} Pts; 

k7_getpt (&pts); /* pointer array 7 

printf ("QPDM driver internal variables are:\n\ 
base_addr[hex]: %x\n\ 
dma_data: %d\n\ 

dmajifo; %d\n\ 

interrupt-#: %d\n", 
pts.k7_cnf->BaseAddress, 
pts.k7_cnf->DmaChannelFifo, 
pts.k7_cnf->DmaChannello,pts.k7_cnf->lnterrupt); 
printf ("EGA driver internal variables are:\n\ 
x_start: %d\n\ 

y_start: %d\n\ 

char_width: %d\n\ 

char_height: %d\n\ 

chars_perjine: %d\n\ 

# of lines: %d\n", 

pts.egawin->x_start,pts.egawin->y_start, 

pts.egawin->charwid,pts.egawin->charheight, 

pts.egawin->nword/pts.egawin->nline, 

pts.egawin->nline); 

} /‘end of example 7 
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Listing A-2: Block I/O Sample #1 


This sample program works only with the QPDM Rev C chip. 

Each QPDM of an 8-bit system must be read separately (see k7__bom and 
k7_bos for block output). The data from each QPDM is packed in a 
"master.dat" and "slave.dat" file. 

Input block works with "k7_bi". The destination of each data stream is 
determined by "k7_act" (setting activity bits). 


tinclude "kon7k.h" 

#include <stdio.h> 

#include <io.h> 

#include <fcntl.h> 

FILE ‘filel, *file2 ; 
int handlel, handle2 ; 

unsigned short configtab[32]; 
unsigned short iv[19400]; 
unsigned short byteread ; 
unsigned short i, j, imax, y=0; 
char dummy; 

main () 

{ 

ini(); 

for (i—0; i<—159; i++) { 
k7_col (i); 

k7_rct (i*4,0,i*4+3,419) /* draw rectangles 7; 

} 
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Listing A-2, continued 


k7Jolk (640,30); /* output block to file on disk 7 

filed = fopen ("master.dat”,"w+b") ; 
for (y=0; y<420;) { 
k7_obl (1,0, y, 4); 

k7_bom (4800, iv); /* read first QPDM (master) 7 

y +— 30 ; 

fwrite( (char *) iv, sizeof(unsigned short), 4800, filel); 

} 

fciose (filel); 

file2 = fopen ("slave.dat","w+b"); 
for (y=0; y<420;) { 
k7_obl (1,0, y, 4); 

k7_bos (4800, iv); /* read 2nd QPDM (slave) 7 

y += 30 ; 

fwrite( (char *) iv, sizeof(unsigned short), 4800, file2); 

} 

fciose (file2); 
k7_col (4); 

k7_txt (150,450,"OUTPUT BLOCK source image"); 


k7_act (Oxff) ; /* zoom part of source image 7 

k7_col (Oxff) ; 

k7_blk (160,105); 

k7_xfm (0,0,0,0,640,0,4,4); 

k7_col (4); 

k7_txt (900,450,"OUTPUT BLOCK zoom-image") ; 
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Listing A-2, continued 


byteread = 9600; /* input block from file on disk 7 

k7_col (4); 

k7_txt (150,950,"INPUT BLOCK destination-image"); 
k7_blk (640,30); 

handlel = open ("master.dat",OJ3INARY); 

k7_act (OxOf); /* enables writing to first QPDM 7 

for (y=0; y<420;) { 

read (handlel, (char* )iv, byteread); 
k7_ibl (1,0, y+500, 4); 

k7_bi (4800, iv); /* writes to QPDM 7 

y += 30; 

} 

close (handlel); 

handle2 = open ("slave.dat",0_BINARY); 

k7_act (OxfO); /* enables writing to 2nd QPDM 7 

for (y=0; y<420;) { 

read (handle2, (char* )iv, byteread); 
k7_ibl (1,0, y+500,4); 

k7_bi (4800, iv); /* writes to QPDM 7 

y += 30; 

} 

close (handle2); 

k7_act (Oxff); /* zoom part of input block image 7 

k7_col (Oxff); 

k7_blk (160,105); 

k7_xfm (0,0,0,0,640,500,4,4); 

k7_col (4); 

k7_txt (900,950,"INPUT BLOCK zoom-image"); 
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Listing A-2, continued 


ini () 

{ 

short i, err; 
int m; 

if (err = k7_ini ("7k.cfg")) 
printf ("ini error #%d\n",err); 
if (err = k7_res()) 

printf ("res error #%d\n",err); 

k7_enq (configtab); 
printf ("Library revision %d.%d\n", 
configtab[6],conf igtab[7]); 
printf ("Screen size x=%d y=%d\n", 
configtab[8],conf igtab[9]); 
ega_color (1); 
egajut (); 
ega_set (0); 

k7_sp (1) ; 

k7_am (ABSOLUTE); 
k7_act (Oxff); 
k7_wm (LZERO); 

k7_rct (0,0, configtab[8], configtab[9]); 
k7_wm (GSET); 


r initialize board 7 
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Listing A-3: Block I/O Sample #2 


#include <stdio.h> 

#include "kon7k.h" 

#include "vram.h" 

#include <malIoc.h> 

#include <math.h> 

#include <stdlib.h> 

#include <string.h> 

#include <fcntl.h> 

#include <sys\types.h> 
#include <sys\stat.h> 

#definexres 512 
#define yres 20 

char Buffer [yres][xres]; 
char mBuffer [xres*yres/2]; 
char sBuffer [xres*yres/2]; 

main (argc, argv) 

int argc; 
char *argv[]; 


int err; 
int i, j; 

for (i=0;i<xres;i++) 
for (j=0;j<yres;j++) 
Buffer m = i; 
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Listing A-3, continued 


if (err=k7_ini ("7k.cfg")) /* init driver */ 

{ printf ("k7Jni: error #%d\n",err);} 

k7_am (ABSOLUTE); 
k7_act (Oxff); 
printf ("bi8 \n"); 
k7_blk (xres,yres); 
k7_ibl (1,100,100,4); 
k7_bi8 (xres*yres/4, Buffer); 
printf ("bom / bos \n"); 
k7_blk (xres.yres); 
k7_obl (1,100,100,4); 
k7_bom (xres*yres/4, mBuffer); 

k7_blk (xres,yres); 
k7_obl (1,100,100,4); 
k7_bos (xres*yres/4, sBuffer); 

printf ("convert in 8 bits/pixel: k7_p4to8 \n"); 
k7_p4to8 (mBuffer, sBuffer, xres'yres, Buffer); 

printf ("k7_bi8 \n"); 
k7_act (Oxff); 
k7_blk (xres, yres); 
k7_ibl (1,100,700,4); 
k7_bi8 (xres*yres/4, Buffer); 

} 
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Listing A-4: File Handler Demonstration 


int handle; 


/* open log file *1 

handle = open ("log",0_CREATE | 0_BINARY); 
k7_fi!out (handle); /* enable QPDM log output 7 

for (i=0;i<100;i++) { 

k7_col (i+1); /* write to QPDM and log file 7 

k7_lin (0,i,1000,i); 

} 

close (handle); /* close log file 7 

k7_filout (-1); /* disable log file output V 
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